[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 TOKENSTR() (STRING)

 Function
  Rebuild a previously tokenized string reconstructed with semi-colons
  separating the component tokens.

 Syntax
  TOKENSTR()   No arguments are required

 Return Type & Value
  STRING
  Returns the rebuilt string that was previously tokenized.

 Remarks
  One of the strongest features of PCBoard is it's ability to take a
  series of stacked parameters from a command line and use them all at
  once instead of requiring the user to navigate a series of menus and
  select one option at each step of the way.  The TOKENIZE statement is the
  PPL equivalent of what PCBoard uses to break a command line into
  individual commands (tokens).  This function will take all pending
  tokens and build a string with appropriate token separators.

  For example, the string "R A S" would be broken into three separate
  tokens; "R", "A" and "S".  TOKENSTR() would take those tokens and return
  the following string:  "R;A;S".  Note that, regardless of the separator
  used in the original string, the semi-colon character will be used in the
  rebuilt string.

 Examples
  STRING  cmdline
  INPUT "Command",cmdline
  TOKENIZE cmdline
  PRINTLN "You entered ",TOKCOUNT()," tokens"
  PRINTLN "Original string:  ",cmdline
  PRINTLN "     TOKENSTR():  ",TOKENSTR()

See Also: GETTOKEN GETTOKEN() TOKCOUNT() TOKENIZE
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson